Txt2Site Examples

Example 1: one root and a few applications

Suppose we want three applications with one root directory.
Define three configuration files and define the system directories as follows:

Then the resulting overall application structure is:

• my_demo
  • my_demo1.conf
  • my_demo2.conf
  • my_demo3.conf
  • my_demo1
    • content
    • include
    • template
  • my_demo2
    • content
    • include
    • template
  • my_demo3
    • content
    • include
    • template
  • site
    • my_demo1
    • my_demo2
    • my_demo3

Remarks:

• The config files are in one directory.
• The sites are in one directory but are separated and can be generated apart.
• No homepage for the joint site and no navigation menu on top of the three sites.
• Links from one site to the other can be manually established. For example to navigate from a page to the homepage of another site (say my_demo2) type:
  href="${path_to_root}../my_demo2/index.html"
• Can be used for multilingual websites where for example:
  my_demo1=english, my_demo2=german and my_demo3=french.

Example 2: showing content files

Showing content files on the website.
This can be done by making the content directory part of the include directory.
For example you can specify in the config file:

• include_dir=include
• content_dir=include/content

Making a link to the content file of the current page you can write the following line in the content file with format txt2tags:

  [Link to contentfile ${path_to_root}include/content${page_source}] 

This works only if path of the link has no spaces (insufficiency of txt2tags). If it has spaces you can use an alternative with pure HTML code:

  <a href="${path_to_root}include/content${page_source}" > Link to contentfile </a> 

Try the link to the contentfile here .

Example 3: post-processing statements txt2tags

In the configuration area of txt2tags, you can use post-processing statements. We recommend three usefull post-processing functionality.

1. A newline in the text can be forced by typing @@.
2. A dollar can be displayed by typing D_. This has to be done to display a bash command without executing it.
3. Simple HTML code can be inserted by using double curly brackets for the delimiters < and >.

For example:

• by typing {{font color="red" }} Red {{/font }}
  
• the generated HTML code is: <font color="red" > Red </font ''>
  
• which is displayed as: Red .
  

In the latest versions of txt2tags you can use tagged output to insert HTML code. For example use double quotation marks ' ' around words to get tagged output. This is a better alternative for the double curly brackets.